home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglgeterror.z / fglgeterror
Encoding:
Text File  |  2002-10-03  |  7.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr - return error information
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      INTEGER*4 ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr( )
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr returns the value of the error flag.  Each detectable error
  18.      is assigned a numeric code and symbolic name.  When an error occurs, the
  19.      error flag is set to the appropriate error code value.  No other errors
  20.      are recorded until ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr is called, the error code is returned, and
  21.      the flag is reset to GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR.  If a call to ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr returns
  22.      GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR, there has been no detectable error since the last call to
  23.      ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr, or since the GL was initialized.
  24.  
  25.      To allow for distributed implementations, there may be several error
  26.      flags.  If any single error flag has recorded an error, the value of that
  27.      flag is returned and that flag is reset to GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR when ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr
  28.      is called.  If more than one flag has recorded an error, ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr
  29.      returns and clears an arbitrary error flag value.  Thus, ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr
  30.      should always be called in a loop, until it returns GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR, if all
  31.      error flags are to be reset.
  32.  
  33.      Initially, all error flags are set to GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR.
  34.  
  35.      The following errors are currently defined:
  36.  
  37.      GGGGLLLL____NNNNOOOO____EEEERRRRRRRROOOORRRR                   No error has been recorded.  The value of
  38.                                    this symbolic constant is guaranteed to be
  39.                                    0.
  40.  
  41.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM               An unacceptable value is specified for an
  42.                                    enumerated argument.  The offending command
  43.                                    is ignored, and has no other side effect
  44.                                    than to set the error flag.
  45.  
  46.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE              A numeric argument is out of range.  The
  47.                                    offending command is ignored, and has no
  48.                                    other side effect than to set the error
  49.                                    flag.
  50.  
  51.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN          The specified operation is not allowed in
  52.                                    the current state.  The offending command
  53.                                    is ignored, and has no other side effect
  54.                                    than to set the error flag.
  55.  
  56.      GGGGLLLL____SSSSTTTTAAAACCCCKKKK____OOOOVVVVEEEERRRRFFFFLLLLOOOOWWWW             This command would cause a stack overflow.
  57.                                    The offending command is ignored, and has
  58.                                    no other side effect than to set the error
  59.                                    flag.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____SSSSTTTTAAAACCCCKKKK____UUUUNNNNDDDDEEEERRRRFFFFLLLLOOOOWWWW            This command would cause a stack underflow.
  75.                                    The offending command is ignored, and has
  76.                                    no other side effect than to set the error
  77.                                    flag.
  78.  
  79.      GGGGLLLL____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMMOOOORRRRYYYY              There is not enough memory left to execute
  80.                                    the command.  The state of the GL is
  81.                                    undefined, except for the state of the
  82.                                    error flags, after this error is recorded.
  83.  
  84.      GGGGLLLL____TTTTAAAABBBBLLLLEEEE____TTTTOOOOOOOO____LLLLAAAARRRRGGGGEEEE            The specified table exceeds the
  85.                                    implementation's maximum supported table
  86.                                    size.  The offending command is ignored,
  87.                                    and has no other side effect than to set
  88.                                    the error flag.
  89.  
  90.      When an error flag is set, results of a GL operation are undefined only
  91.      if GGGGLLLL____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMMOOOORRRRYYYY has occurred.  In all other cases, the command
  92.      generating the error is ignored and has no effect on the GL state or
  93.      frame buffer contents.  If the generating command returns a value, it
  94.      returns 0. If ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr itself generates an error, it returns 0.
  95.  
  96. NNNNOOOOTTTTEEEESSSS
  97.      GGGGLLLL____TTTTAAAABBBBLLLLEEEE____TTTTOOOOOOOO____LLLLAAAARRRRGGGGEEEE was introduced in GL version 1.2.
  98.  
  99. EEEERRRRRRRROOOORRRRSSSS
  100.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr is executed between the
  101.      execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.  In this
  102.      case ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr returns 0.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.